package lormi.meipin.service;

import lormi.meipin.entity.City;
import lormi.meipin.vo.CityVo;

import java.util.List;
import java.util.Map;

/**
 * 城市信息接口
 * @author ThreeFeng
 * @date 2016年8月12日 下午5:46:13
 */
public interface ICityService {

	/**
	 * 获取所有省份（level=province）
	 * @return
	 */
	List<City> getAllProvinces();
	
	/**
	 * 通过地区名称获取相应的信息（level=all）
	 * @param name
	 * @return
	 */
	City getByCityName(String name);
	
	/**
	 * 获取一个省份下的所有城市（level=city）
	 * @param privinceid
	 * @return
	 */
	List<City> getAllCityByPrivince(String privinceid);
	
	/**
	 * 获取一个省份下的所有城市（level=district）
	 * @param cityid
	 * @return
	 */
	List<City> getAllDistrictByCityId(String cityid);
	
	/**
	 * 按照城市首字母排序,格式:[{"city":城市对象,letter:"首字母"},]
	 * @return
	 */
	List<CityVo> getAllCitySortAZ();
	
	/**
	 * 按照城市首字母排序,格式:{"首字母":[city1,city2,]},]
	 * @return
	 */
	Map<String,List<City>> getAllerCitySortAZ();
	
	/**
	 * 获取热门城市
	 * @return
	 */
	List<City> getHotCity();
}
